home *** CD-ROM | disk | FTP | other *** search
- Sozobon eXtended version (ATARI)
-
- readme in english and german
-
- to distribution of Sep 10 1995
- (sozbin14.zoo sozlib15.zoo sozuti04.zoo)
-
-
- updating hints:
- bugs in HCC and TOP fixed, HCC processes ANSI function prototypes
- changes to HCC and TOP
-
-
- updating from older versions (1994):
- The structure in 'sozdistr/doc' has completely changed, so remove
- this directory bevor unpacking or copying!
- hcc: IEEE 64 Bit floating point support, ANSI prototypes and parm type checking
- libm: now the pml, for IEEE support
- libc: IEEE support, bugfixes
- startups: some new ones
- xgemfast: MagiC support
- see '*.chg' files for further information!!
-
-
- This is the only file with 'CRLF' newlines in this distribution, I
- think. If anyone has trouble with missing '^M's I can change this.
-
- This SOZOBON version is based on SOZOBON-C 2.00 release of Sozobon Limited
- (Tony Andrews, Johann Ruegg and Joe Treat). It includes a library based on
- Dale Schumacher's Dlibs and Ian Lepore's Gemfast. Changes by Holger Weets,
- Christian Wempe and Jerry Geiger, with the help of Harun Scheutzow
- and Michel Forget.
- Now we have two new peolpe helping to maintain SozobonX, this is
- Volker Seebode for hcc, top and Thorsten Roskowetz for jas.
-
-
- The documents are based on original distributions' ones.
-
- SozobonX is distributed in five archives:
- The files 'sozbinXX.lzh', 'sozlibXX.lzh', and 'sozutiXX.lzh', are the
- standard parts. The XX stands for each file's distribution number.
- The file 'sozc68XX.lzh' with Thosten Roskowetz's c68 port, and the
- file 'mntsoxXX', the MiNT library (Scott Bigham) where the 'XX' is the
- patch level.
- It is guaranteed that the highest numbers always fit together -- as far as I
- guarantee anything. So the mntsox44.lzh won't work using doubles at all.
- The files will be called sozlib, sozbin and sozuti in the documentation.
-
-
- COPYRIGHT
-
- The Sozobon C-Compiler is freeware. The archives 'sozbin', 'sozlib',
- and 'sozutil' may be freely copied, so long as they are not sold nor
- changed. This package may not be distributed in any PD-Library or
- Shareware series.
-
- If you want to add this compiler system or parts of SOZOBONX to any
- commercial software distribution (CDs etc) please contact me for a
- permission.
-
-
- DISCLAIMER
-
- IN NO EVENT WILL I AND/OR ANY OTHER PARTY BE LIABLE TO YOU FOR DAMAGES,
- INCLUDING ANY LOST PROFITS, LOST MONIES, OR OTHER SPECIAL, INCIDENTAL OR
- CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE (INCLUDING
- BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES
- SUSTAINED BY THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH OTHER
- PROGRAMS) THE PROGRAM, EVEN IF YOU HAVE BEEN ADVISED OF THE POSSIBILITY OF
- SUCH DAMAGES, OR FOR ANY CLAIM BY ANY OTHER PARTY.
-
-
- CONTENTS
-
- In the archive 'sozbin' you will find the programs that form that
- Freeware C-System Sozobon eXtended version (2.xx), including the manual
- files and the more global Sozobon 2.0x documentation.
-
- The basic executables are:
-
- * Compiler Driver (cc)
- * Compiler (hcc)
- * Optimizer (top)
- * Assembler (jas)
- * Linker (ld)
-
- In the archive 'sozlib', you will find libraries and header files,
- and the library documentation.
-
- * Header Files
- * Startup Modules/Libraries
-
- In the archive 'sozutil', you will find various utilities, to deal
- with sorce files, libraries and bugs.
-
- * Make (make)
- * Prototypes Creation Utility (mkptypes)
- * Include File Precompiler (ipc)
- * Library Mananger (ar, har)
- * Tagfile Utility (tagfile)
- * Source Analysis Utility (clint)
- * Debugger not in this distribution
- * Debug Utility (debug)
-
- In the archive 'c-desk.lzh' (if present) you will find a GEM shell for
- Sozobon C called C-Desk, by Holger Weets. ACE (shell and integrated editor)
- is available by him, too.
- An identical AMIGA version is available by Holger Weets. He can be
- contacted at:
-
- Maus: Holger Weets @ OL
- Internet: Holger_Weets@OL.maus.de (only mails <= 16KBytes !!)
-
- Mail: Holger Weets
- Tangastraße 45
- D-26121 Oldenburg
-
-
- The traditional installation of many C compilers (UNIX) can be used
- for Sozobon. Unpack the archives with option '-r', to get
- all directories created. All three archives use the same directory
- structure and will create a directory 'sozdistr' where all is placed
- in. If you think of this directory 'sozdistr' as 'usr' you will see
- the usual direcory structure, excepted the directory 'doc' placed
- there and this file 'readme'.
-
- The simplest way is now to copy or move the directories 'bin'
- 'include' 'lib' and 'man' to your directory '\usr\'. If you don't
- have a '\usr' try the following four steps.
-
- 1. Put the executable files (directory 'bin') in a folder called
- '\usr\bin' or '\bin' or whatever you use for binaries.
- You can also put these files in any folder that is present in the
- $PATH environment variable.
-
- 2. Copy or move the directory 'include' where ever you
- think its a good place for. Usually you should have a directory
- '\usr\include\' with some and library specific directories like
- '\usr\include\mntinc' with the most include files in it.
-
- 3. Copy or move the directory 'lib\sozobonx' to where you want it,
- usually this will result in a path '\usr\lib\sozobonx' with
- all the library directories and files in it.
-
- 4. The man files' directories should be placed in a directory
- '\usr\man', when your environment variable $MANPATH has the
- value '\usr\man'.
- If you don't know what $MANPATH is keep the files where they are
- or use the ones of directory 'doc' in 'sozdistr'
-
- Now you have to create some environment variables:
-
- Create an environment variable called $INCLUDEDIR that contains the
- path of your include directory ('\usr\include' by default). cc uses
- this variable to build a variable $INCLUDE for cpp and hcc from it.
- hcc uses it to replace the buildin path for header files, if $INCLUDE
- doesn't exist.
-
- Create an environment variable called $LIBDIR that contains the
- path of your library directory ('\usr\lib'). cc will replace the
- builtin library pathes with this one.
-
- You may need these variables, cause with TOS there are a) drives and
- b) for other reasons too, no standard directories 'usr\include' and
- '\usr\lib'.
-
- You can use the variables $LIB and $INCLUDE, too and cc, hcc and ld
- will use them instead of the above mentioned. Additionally Sozobon
- cc pl>=05 first looks for $SOZBIN, $SOZINC and $SOZBIN before
- it uses $PATH, $INCLUDE, $LIB.
-
- Sozobon makes use of the well known (I hope) environment variables
- PATH and TMPDIR. (the last one should name the path of something
- like the directory '\usr\tmp'.
-
- If you have installed the ST-Guide program copy the '*.hyp' and
- '*.ref' files from directory 'doc' in this distribution where you
- keep you hypertext files (maybe '\usr\lib\hyper', maybe anywhere.
- Run 'stool' to get them in the catalouge file and tell your editor,
- that the C-mode-editing helpfile is 'soz_libs.ref'
-
- Of course you can put the files where you want, but the sozobon
- programs sometimes need to find the single files. Therefore you have to
- set the environment variables. C-Desk and ACE use setup files, to store
- the paths, but you can use environment variables, too.
-
- These following environment variables are used by sozobon components.
- 'make', 'cc', and 'ld' handle and expand some $UNIXMODE path features.
-
- PATH to find binaries (list of paths)
- LIBDIR standard library path (path)
- (there a directory 'sozobonx')
- replaces the builtin include paths
- LIB current valid library pathes (list of paths)
- INCLUDEDIR standard header file path (path)
- (there some library directories)
- replaces the builtin include paths
- INCLUDE current valid include file paths (list of paths)
-
-
- More detailed installation hints are to find in the documents to the
- shell (C-Desk.doc ...) or the driver program (cc.man) you use.
-
- ANOTATIONS
-
- Now there is a 'Let'em Fly' library included, see in the original
- Let'em Fly docs how to use it.
-
-
-
- SUPPORT
- BUG REPORTS
-
- If you have any problems, suggestions, or comments, send a message
- to me. If you have a bugreport please use the bugform file, included in
- this distribution. At least for the first one.
-
- If you have a bugreport to hcc, top or jas or another part of SozobonX
- wich is no more maintained by me plese send you filled bugforms to the
- person mentioned in the man file of this tool.
-
-
- email to:
-
- Internet: seebode@plesnik.bonsai.de
-
-
- If you want to be the new mainter and/or SozobonX maintaning coordinator
- please send an email to
-
- jerry@zedat.fu-berlin.de
- seebode@plesnik.bonsai.de
-
-
- --Jerry, Volker
-
- Now the whole stuff and some lines more in german.
-
- Update Hinweise:
-
- bugs in HCC und TOP gefixed, HCC verarbeitet ANSI Prototypen und Parameterprüfung
- Änderungen an HCC, TOP und JAS
-
-
- von älteren Versionen:
- Die Struktur des Verzeichnisses 'sozdistr/doc' wurde völlig geändert,
- löschen sie deshalb diese(s) Verzeichnis(e) vor dem Auspacken bzw Kopieren
- der neuen Archive.
-
- hcc: IEEE 64 Bit floating point ANSI Prototypen
- libm: nun die pml, wegen IEEE Unterstützung
- libc: IEEE Routinen, bugfixes
- startups: ein paar neue sind hinzugekommen
- xgemfast: MagiC Unterstützung
- siehe auch die '*.chg' Dateien für weitere Informationen
-
-
- SozobonX wird in fünf Dateien verteilt:
- Die Dateien 'sozbinXX.lzh', 'sozlibXX.lzh' und 'sozutiXX.lzh' enthalten das
- Basis Paket, wobei XX jeweils für die fortlaufende Versionsnummer des
- jeweiligen Archivs steht.
- Die Datei 'sozc68XX.lzh' enthält Thosten Roskowetzs c68 Portierung, und die
- Datei 'mntsoxXX' die MiNT library (Scott Bigham); wobei 'XX' jeweils den
- Patch Level angibt.
- Die Dateien mit den höchsten Nummern passen jeweils zusammen, außer derzeit
- mntsox44.lzh, das noch nicht mit den IEEE doubles umgehen kann.
- Im folgenden werden die Archiv-Dateien als sozlib, sozbin und sozuti
- bezeichnet.
-
- COPYRIGHT
-
-
- Der Sozobon C-Compiler ist Freeware. D.h. die drei hier genannten
- Archive sozbin, sozlib und sozutil dürfen kopiert und weitergegeben werden,
- solange an ihnen nichts verändert wird, und keine Kosten in Rechnung
- gestellt werden.
-
- Eine kommerzielle Weitergabe/Verteilung sowie Verkauf von Disketten mit
- dem Compilersystem bzw. Teilen davon, oder das Beilegen zu anderen
- Programmpaketen Bedarf des ausdrücklichen Einverständnisses der derzeitigen
- Autoren/Entwickler.
-
- HAFTUNG
-
- Weder ich noch Holger Weets, noch sonst jemand haftet für irgendwelche
- Schäden, die in Zusammanhang mit der Benutzung irgendwelcher Dateien aus dem
- Sozobon-Paket möglicherweise entstehen oder entstanden sind. Dabei spielt
- es keine Rolle ob diese Dateien für die ihnen zugedachten Zwecke oder zu
- anderen Zwecken eingesetzt wurden.
-
-
- CONTENTS
-
- In dem Archiv 'sozbin' befinden sich die wesentlichen Programme des
- Freeware C-Systems SOZOBON 2.0 eXtended version, sowie die Manual Seiten
- und die allgemeinere Sozobon 2.0x Dokumentation.
-
- Die grundlegenden Programme sind:
-
- * Compiler Driver (cc)
- * Compiler (hcc)
- * Optimizer (top)
- * Assembler (jas)
- * Linker (ld)
-
- In dem Archiv 'sozlib' befinden sich Header/Include Dateien und
- die Bibliotheken.
-
- * Header Files
- * Startup Modules/Libraries
-
- In dem Archiv 'sozutil' finden sich folgende mehr oder weniger
- verzichtbare utilities:
-
- * Make (make)
- * Prototypes Creation Utility (mkptypes)
- * Include File Precompiler (ipc)
- * Library Mananger (ar, har)
- * Tagfile Utility (tagfile)
- * Source Analysis Utility (clint)
- * Debugger not in this distribution
- * Debug Utility (debug)
-
-
- Im Archiv 'c-desk.lzh' (wenn vorhanden) ist die GEM-Oberfläche für
- SOZOBON enthalten (C-Desk von Holger Weets). Von ihm kann auch ACE
- (Oberfläche mit integriertem Editor) bezogen werden.
-
- Eine identische Version für den AMIGA ist ebenfalls bei Holger erhältlich,
- sie enthält den hcc & top sowie die neuste Version des A68K und die
- PD-Version des BLINK, sowie entsprechende Bibliotheken.
-
- Maus: Holger Weets @ OL
- Internet: Holger_Weets@ol.maus.de (only mails <= 16KBytes !!)
-
- Mail: Holger Weets
- Tangastraße 45
- D-26121 Oldenburg
-
-
- INSTALLATION:
-
- Die traditionelle Installation eines Compilers (UNIX) ist auch
- Grundlage für Sozobon. Packen sie die Archive mit der Option '-r' aus,
- um die enhaltenen Verzeichnisse zu bekommen. Alle drei Archive haben
- die gleiche Verzeichnisstruktur, und erzeugen ein Verzeichnis
- 'sozdistr', das alles enthält. Dieses Verzeichnis entspricht dem
- verzeichnis '\usr' in einer Standard-Installation, außer daß das
- Verzeichnis 'doc' und diese Datei 'readme' auch darin zu finden sind.
-
- Der einfachtse Weg der Installation ist nun die Verzeichnisse 'bin',
- 'lib', 'include' und 'man' in ihr 'usr' Verzeichnis zu verschieben
- oder zu kopieren. Wenn sie kein Verzeichnis 'usr' haben, probieren
- sie folgende vier Schritte:
-
- 1. In ein Verzeichnis '\usr\bin' oder '\bin' (oder ein anderes
- Verzeichnis in $PATH) sollten die ausfühbare Programme (aus 'bin')
- kopiert werden.
-
- 2. Kopieren oder verschieben sie nun in das Verzeichnis
- '\usr\include' oder '\include' den Inhalt von 'include' aus der
- Sozobon Verteilung. Es sollte so etwas wie '\usr\include\' mit
- ein paar und die Bibliotheks spezifischen Verzeichnisse wie
- '\usr\include\xdlibs\' mit dem ganzen Rest von
- Header Dateien enstanden sein.
-
- 3. Das gleiche Spiel nun mit 'lib' aus der Verteilung. Die
- Bibliotheksdateien sollten nun alle in so etwas wie
- '\usr\lib\sozobonx' zu finden sein.
-
- 4. Alle beliegenden Manual Verzeichnisse sollten in ein Verzeichnis wie
- '\usr\man\' kopiert oder verschoben werden, wenn ihre
- environment Variable MANPATH den Wert '\usr\man' hat.
- Wenn sie nicht wissen was $MANPATH ist und sie 'man' auch nicht
- kennen lassen sie sie wo sie sind, und benützen sie die Dateien
- aus dem Verzeichnis '\sozdistr\doc'
-
- Nun wären noch ein paar Environment Variablen zu erzeugen:
-
- In der environment Variablen $INCLUDEDIR sollte dann der Pfad ihres
- '\usr\include' entsprechenden Verzeichnisses zu finden sein. hcc
- ersetzt mit dieser Variablen die eingebauten standard Include-Pfade
- wenn $INCLUDE nicht gesetzt ist. cc benutzt diese Variable um für hcc
- und cpp eine passende $INCLUDE Variable zusammenzubauen
-
- Erzeugen sie auch eine environment Variable 'LIBDIR', die den Pfad des
- Bibliotheks-Verzeichnisses ('\usr\lib') enthält. cc ersetzt mit
- dieser Variablen die eingebauten standard Bibliotheks-Pfade.
-
- Dies ist ganz nützlich, da es unter TOS a) Laufwerke und b) nicht nur
- deshalb keine Standard Verzeichnisse '\usr\include' und '\usr\lib'
- gibt.
- Sie können auch die Variablen $INCLDUE und $LIB benutzen cc, hcc und
- ld verwenden dann die oben erwähnten nicht. Seit cc pl>=05 werden
- zusätzlich die Variablen $SOZBIN, $SOZINC und $SOZLIB vor $PATH, $INCLUDE
- und $LIB ausgewertet um Konflikte mit anderen Programmen zu vermeiden.
-
- Natürlich kann das jeder alles machen wie sie will, wichtig ist nur, daß
- die Sozobon Programme die einzelnen Dateien finden. Dazu müssen jeweils die
- Environment-Variablen gesetzt werden. Bei C-Desk und ACE werden diese Pfade
- in entsprechenden Setup Dateien gespeichert.
-
- Folgende Environment Variablen werden von den Sozobon Komponenten benutzt:
-
- PATH für binaries (Liste von Pfaden)
- LIBDIR standard Bibliothekspfad (Pfad)
- (dort ein Verzeichnis sozobonx)
- ersetzt eingebaute Pfade
- LIB die aktuelle gültigen Bibliothekspfade (Liste von Pfaden)
- INCLUDEDIR standard Include Pfad (PFAD)
- (dort ist die Bibliotheks Verzeichnisse)
- ersetzt die eingebauten Include Pfade.
- INCLUDE aktuell gültige Include Pfade (Liste von Pfaden)
-
- Es empfielt sich generell die Defaultpfade zu verwenden.
-
- Für detailliertere Angaben zur Installation sollten die zur verwendeten
- Oberfläche gehörenden Dokumentationen zu Rate gezogen werden. (cc.man,
- C-Desk.doc ...)
-
-
- ANMERKUNGEN
-
- CC und MAKE sind für die Benutzung des Systems mit den
- Oberflächen ACE oder C-Desk nicht notwendig, jedoch die Schnittstelle zur
- Benutzung von SOZOBON in einer CLI-Shell, einem modernen Desktop wie
- etwa Gemini oder etwa von Emacs aus.
-
- CC und MAKE wurden von mir gegenüber den ursprünglichen Versionen stark
- modifiziert. Ein komplettes Manual für make fehlt allerdings immer noch.
- Ich habe jedoch die Einführung in make von Ian Lepore (make.doc) beigelegt.
-
- Compiler, Optimizer, Asembler und Linker wurden stark
- modifiziert, so daß sie
- - schnelleren Code erzeugen
- - keine bekannten Fehler mehr enthalten
- - schneller übersetzen
- - auch auf AMIGA's laufen (durch einmaliges neu übersetzen)
- - viele Erweiterungen enthalten
-
- Den Bibliotheks-Manager hat Holger komplett neugeschrieben, er
- liegt jetzt als GEM-Programm vor (ist für die Amiga-Version
- aktuell noch nicht erhältlich) und funktioniert im Gegensatz zum
- Original auch ordentlich.
-
-
- IPC und TAGFILE sind im Original SOZOBON-Paket nicht enthalten,
- sie wurden von Holger geschrieben.
-
- Einige weitere utilities liegen der Original Verteilung ebenfalls nicht bei.
-
-
- Die Sourcecodes der modifizierten Version liegen nicht bei, weil
- wir nicht möchten, daß es innerhalb kurzer Zeit eine Vielzahl von
- verschiedenen Versionen dieses Systemes gibt.
-
- Die Sources der Original-Version (2.0 von SOZOBON) können bei Holger
- gegen einen frankierten und adressierten Rückumschlag bezogen
- werden. Sie sind auch in diversen Mailboxen und von file-servern zu
- beziehen.
-
- Ich habe eine SozobonX version der Let'em Fly lib von O. Scheel
- beigelegt, ich hoffe es ist in seinem Sinne.
- Anwendung: '#include <ltmf_lib.h>' im source file
- und '-lltmf' in der cc commandline nicht vergessen.
-
-
- SUPPORT
- BUG REPORTS
-
- Generelle Bug reports, Fragen, etc. bitte an uns. Wenn sie einen Fehler
- (Bug) zu berichten haben benützen sie bitte die beiligende Datei 'bugform',
- wenigstens das erste Mal.
- In den man files finden sich die Adressen der Leute die das
- entsprechende tool pflegen, bitte die ausgefüllten 'bugform's direkt an sie
- schicken.
-
- Da ich keine Zeit mehr habe - wenigstens in den nächsten Monaten -
- mich um SozobonX zu kümmern sendet die bugreports bitte an jemand der schon
- mit irgenwelchen SozobonX Komponenten befaßt ist.
-
-
- email to:
-
- zur Zeit: seebode@plesnik.bonsai.de
- MAUS-Netz: Volker Seebode @ AC3
-
- Wir hoffen es findet sich jemand die/der sich um SozobonX kümmern
- will.
-
- --Jerry, Volker
-
- -eof
-